Keysight 89600 VSA .NET API
ChangeLogicalChannels(ChannelId[]) Method
See Also 
Agilent.SA.Vsa.Interfaces Assembly > Agilent.SA.Vsa Namespace > Input Class > ChangeLogicalChannels Method : ChangeLogicalChannels(ChannelId[]) Method


inputChannelIds
The channel identifiers that correspond to the desired channels. See ChannelId.

Glossary Item Box

Changes the input channel configuration for the current measurement by specifying specific input channels (using channel identifiers).

Syntax

Visual Basic (Declaration) 
Public Overloads MustOverride Sub ChangeLogicalChannels( _
   ByVal ParamArray inputChannelIds() As ChannelId _
)
C# 
public abstract void ChangeLogicalChannels( 
   params ChannelId[] inputChannelIds
)
C++/CLI 
public:
abstract void ChangeLogicalChannels( 
   ... array<ChannelId>^ inputChannelIds
)

Parameters

inputChannelIds
The channel identifiers that correspond to the desired channels. See ChannelId.

Exceptions

ExceptionDescription
System.ArgumentNullExceptioninputChannelIds is null.
System.ArgumentOutOfRangeExceptioninputChannelIds is not possible with the currently selected hardware.

Remarks

This method assumes that each of the specified input channels will be used as a logical channel. Internally it uses an instance of LogicalChannelId for each specified input channel with the LogicalChannelOperation set to LogicalChannelOperation.None.

Hardware Interchangeability: Do not use this method if hardware interchangeability is important. A channel identifier is only valid and unique within the context of the model(s) of hardware being used.

Affect on Traces: Undefined. The Measurement.PresetTraces, RemoveExtra, and TraceCollection.ArrangeWindows methods may be useful in presetting traces to a default number, result assignment, and layout after changing the channel configuration.

Requirements

Target Platforms: Windows 11 Professional or Enterprise; Windows 10 Professional, Enterprise, or Education (64-bit)

See Also